home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / morse / procw / pro_cw.txt < prev    next >
Text File  |  1990-09-02  |  21KB  |  577 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                  PRO-CW
  10.  
  11.                   The Professional CW Keyboard Software
  12.  
  13.  
  14.                    Copyright 1990, Andrew C. Manti Jr.
  15.  
  16.  
  17.  
  18.  
  19.      Welcome to PRO-CW, the CW keyboard software for the casual ham as
  20.      well as those who enjoy contesting.  PRO-CW was written by a ham
  21.      and incorporates the features most needed for a CW keyboard, both
  22.      for casual CW work, and use in contests (specifically designed with
  23.      the ARRL Sweepstakes in mind).  Also included is the ability to
  24.      decode morse from the receiver and display text on the screen.
  25.      This program does, however require some minimal hardware to
  26.      interface to your ham gear. Details of this interface are given
  27.      later.
  28.  
  29.      The major features of the program are as follows:
  30.  
  31.               - Self calibrating to your system clock. (No need to set
  32.                 special speed constants)
  33.               - Speeds from 5 to 60 wpm.
  34.               - Unlimited ASCII message files each containing up to 9
  35.                 different 80 character messages.
  36.               - Auto incrementing serial number for contest work.
  37.                 (Also ability to repeat last serial number used.)
  38.               - Optional input and output pin assignments for RS232C
  39.                 port.
  40.               - Type ahead buffer.
  41.               - Ability to prepare message while other station is
  42.                 transmitting.
  43.               - Adjustable dot/dash weighting.
  44.               - Automatically saves last used configuration including
  45.                 serial number count.
  46.               - Received CW decoding. (Still in its early stages with
  47.                 this release but does work.)
  48.  
  49.  
  50.      System requirements are an IBM PC or compatible with 384K of RAM,
  51.      and an RS232C port.  A description of the required computer to ham
  52.      gear interfaces is given later.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.      PRO-CW is offered as shareware. That is, software which you are
  75.      free to copy, distribute, and try for a limited time.  If you feel,
  76.      the program is of real use to you then you are obligated to
  77.      register your copy of the program.  The program and this document
  78.      are copyrighted and protected under US Copyright laws.
  79.  
  80.      In trying to determine an appropriate registration fee, the author
  81.      came up with some mixed feelings.  The author is a ham, and as a
  82.      ham realizes the need for more and better software to be made
  83.      available to the ham population at low cost.  What with the cost of
  84.      equipment today, not many people have $50-$100 to throw at every
  85.      decent software package they see.  This program did however take
  86.      many hours to develop and prepare for use.
  87.  
  88.      With this in mind, and the fact that it is expected that future
  89.      improvements and additions will be made, it was decided that the
  90.      registration fee would be set at $15.00.  For this registration
  91.      fee, you will receive a direct mail copy of the next major update
  92.      to the program when released.  Naturally, the number of comments
  93.      and suggestions received may determine the next release date.
  94.  
  95.      If you use PRO-CW and feel it is of real use to you, send your $15
  96.      registration fee (MA residents must add 5% tax) to:
  97.  
  98.                         Andrew C. Manti Jr.  W1VL
  99.                         2 Deana Road
  100.                         Methuen, MA 01844
  101.  
  102.      (Please send check or money order (no cash) payable to Andrew C.
  103.      Manti Jr.  A registration form is included at the end of this
  104.      document.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.      To run PRO-CW, merely copy the files PROCW.EXE, CALIB.MSG and
  135.      CWXMIT.CNF to a floppy or your hard disk.  As received, the program
  136.      is set up to use the CTS pin (pin 5) for receive and the RTS pin
  137.      (pin 4) for transmit over your RS232 line. It is set up to be used on
  138.      COM1 only at this time.  More on this later.
  139.  
  140.      To begin PRO-CW, at the DOS prompt type PROCW and <ENTER>. If you
  141.      are running the program on a monochrome monitor or a laptop with an
  142.      LCD display, start the program by typing PROCW M and then <ENTER>.
  143.      The "M" on the command line will instruct the program to run in
  144.      monochrome mode as opposed to color.
  145.  
  146.      When the program starts, an opening screen will appear while the
  147.      program calibrates itself to your system clock.  The program will
  148.      automatically determine the clock speed and set up its parameters
  149.      accordingly.  This means no playing with speed constants or the
  150.      like.  The method used to calibrate is very accurate and test on
  151.      six different types of computers showed variations of only one half
  152.      word per minute.
  153.  
  154.      Once the calibration program completes, the main operating screen
  155.      will appear.  This screen is a split screen, the top of which is
  156.      used for transmit data and the bottom for either received data or a
  157.      buffer for the transmit option.  At the bottom of the screen is a
  158.      box which will show the present transmit speed and the next serial
  159.      number to be used in the sequential serial number routine.  Below
  160.      the box, is the function key defintion for transmit (or receive),
  161.      as well as a listing of keys for use as special symbols (BT, SK,
  162.      etc).  On the right hand side of this line is the work SPKR:. This
  163.      is followed by either ON or OFF and gives the state of the PC
  164.      speaker.  If ON, everything you type will be echoed by the speaker
  165.      as well as sent out the RS232 port. The <F3> key is the toggle for
  166.      the speaker.  The program initially begins with the speed set at 13
  167.      WPM and the speaker ON.  Without using the RS232 port, the program can
  168.      be used for code practice.
  169.  
  170.      To view a listing of function key assignments press <F1>. This may
  171.      be done at anytime the program is in the transmit mode.  A summary
  172.      of these keys is as follows:
  173.  
  174.                    F1   - Help
  175.                    F2   - Exit Program (Return to DOS)
  176.                    F3   - Toggle PC speaker ON and OFF
  177.                    F4   - Load ASCII message file
  178.                    F5   - Clear Receive/Buffer Area
  179.                    F6   - Set Speed
  180.                    F7   - Change Dot/Dash Weight Ratio
  181.                    F8   - Change RS232 Port Pin Assignments
  182.                    F9   - Enter Transmit Mode
  183.                    F10  - Enter Receive/Buffer Mode
  184.  
  185.                    <ALT><1> - <ALT><9> - Transmit message 1 - 9 of ASCII
  186.                                          message file
  187.  
  188.                    <SHIFT><F5>  - Save curent settings
  189.                    <SHIFT><F7>  - Reset Serial Number Counter
  190.  
  191.  
  192.      Most of these functions are self explanatory but will be covered
  193.      briefly later.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      BASIC USAGE of PRO-CW
  203.      =====================
  204.  
  205.      Transmitting:
  206.  
  207.      Once you have connected the appropriate interface hardware to your
  208.      computer, you are ready to begin.  Transmitting CW is very straight
  209.      forward.  The program always begins in the Transmit (XMIT) mode.
  210.      The cursor on the screen will be in the top or transmit window.  To
  211.      send morse, all you have to do is type what you wish to send and it
  212.      is sent!  Nice and easy!
  213.  
  214.      If you wish to change speeds, press the <F6> key. The cursor will
  215.      move to the SPEED indicator at the bottom of the screen. Type in
  216.      the new speed and press enter.  The cursor will return to the
  217.      transmit window and you are ready to continue.
  218.  
  219.      Should you prefer a different dot/dash weighting ratio than the
  220.      standard 3:1, press <F7>.  A window will open and allow you to
  221.      change the ratio from 2 to 5.  This means dashes will be from 2 to
  222.      5 times longer than dots.  Remember, 3 is the normal weight ratio.
  223.  
  224.      ASCII Messages:
  225.  
  226.      PRO-CW allows you to use any number of predefined ASCII message
  227.      files.  Each of these files may contain from 1 to 9 different
  228.      messages. The files may be created using any standard word
  229.      processor capable of writing true ASCII files.  Each file may
  230.      contain up to 9 lines of 80 characters each.  Each line is
  231.      considered a separate message.  For example, the author uses the
  232.      following file for the ARRL Sweepstakes:
  233.  
  234.               NR # A W1VL 60 EMA =
  235.               NR ! A W1VL 60 EMA =
  236.               NR !  NR ! =
  237.               A   A =
  238.               W1VL =
  239.               60  60 =
  240.               EMA  EMA =
  241.               CQ SS DE W1VL SS K
  242.  
  243.      This is actually 8 separate messages which can be selected by
  244.      typeing the <ALT> key and the number key corresponding to the
  245.      appropriate line or message.  In other words, to send CQ SS, press
  246.      <ALT><8>. The message will be transmitted immediately.
  247.  
  248.      Did you notice the couple of strange characters in the file
  249.      listing?  The # character tells the program to insert the next
  250.      sequential serial number in the message at that point. Each time I
  251.      send message 1 (<ALT><1>), it will send a different serial number.
  252.      The other character to note is the !.  The ! tells the program to
  253.      repeat the LAST serial number that was sent.  Message 2 allows me
  254.      to repeat the entire exchange without increasing the serial number.
  255.  
  256.      The other message lines allow me to repeat any portion of the
  257.      exchange without having to keep retyping.  For a repeat of my
  258.      section, just type <ALT><7>.  The = is the character code for <BK>
  259.      These codes will be covered next.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.      The other special codes for use during transmit are as follows:
  273.  
  274.               =     <BK>
  275.  
  276.               -     <BT>
  277.  
  278.               ;     <AR>
  279.  
  280.               ]     <SK>
  281.  
  282.               [     <KN>
  283.  
  284.               @     <AS>
  285.  
  286.      These codes should cover just about any you may need.
  287.  
  288.  
  289.      While transmitting, you may type ahead as far as you want.  No
  290.      problems have been found with using up buffer space.  I imagine, if
  291.      you send at 5 wpm and type at 60 wpm, you may run into a problem,
  292.      but don't think that is likely.  To correct while you are typing,
  293.      just press the BACKSPACE key and continue.  The program will
  294.      automatically make the correction before the text is sent.
  295.  
  296.      The receive portion of the screen which will be covered next, has a
  297.      second use and that is as a message preparation buffer for
  298.      transmitting.  If you are listening to another station and wish to
  299.      begin preparing your transmission, press <F10> which will place you
  300.      in the receive mode.  The cursor will move to the bottom window. At
  301.      this time you may begin typing your next transmission.  The
  302.      characters you type will appear in the bottom window.  When you are
  303.      ready to send the message, press <F9> which will return you to the
  304.      transmit window and your prepared message will be sent immediately.
  305.      This is a handy feature if you are as poor a typist as I am.
  306.      Obviously once this message has been sent, it can only be repeated
  307.      by retyping it as opposed to the message file options which will
  308.      repeat every time you press the appropriate ALT key combination.
  309.      Keep in mind that this option of using the receive window for a
  310.      transmit buffer works whether or not you are actually receiving
  311.      with the program.  If you are, however, the information you type
  312.      will overwrite anything being received.
  313.  
  314.      To clear the Receive or lower window, press <F5>.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.      Receive Mode:
  338.  
  339.      The receive mode in this version does works well with machine sent
  340.      or near perfect code.  It runs about 92% accurate in these cases.
  341.      With QRM, QRN and average or below average code, the accuracy drops
  342.      quickly.  At this time, the accuracy depends greatly on your
  343.      receiver selectivity and actual operating conditions.  The
  344.      algorithm used is pretty reliable, but was included to give the
  345.      program an extra feature more than to take the place of good solid
  346.      paper and pencil or head copy.  I find it very useful in copying
  347.      W1AW bulletins and the like.
  348.  
  349.      The external hardware for the receive protion of the program is
  350.      much more involved than the transmit hardware.  Even then, the
  351.      parts can be bought at most Radio Shack stores for under $10
  352.      excluding cabinet and power supply.  You may want to experiment
  353.      with other receiver to computer interfaces. I would be interested
  354.      in hearing about any you may come up with.
  355.  
  356.      To get into the receive mode, press <F10>.  This will move the
  357.      cursor to the bottom window and any received code will be
  358.      displayed.  Note that each time you go into receive, it will take a
  359.      few characters for the software to adjust itself to the received
  360.      speed.  There are no adjustments necessary.  The software seems to
  361.      adjust well from 5 to about 35 wpm.  At slower speeds, (under 10-12
  362.      wpm) you may find that the characters that are displayed are always
  363.      separated by a space. This is due to the timing loops in the
  364.      program.
  365.  
  366.      It is also not unusual to have anywhere from a couple characters to
  367.      a couple lines of characters be displayed in the presence of high
  368.      noise levels or static crashes.  It's tough explaining to a
  369.      computer what QRM is!
  370.  
  371.      To exit from the receive mode press <F9> and you will be returned
  372.      to the transmit mode.
  373.  
  374.  
  375.      To exit the program press <F2> while in the transmit mode.  All
  376.      settings will be saved and you will be returned to the DOS prompt.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      RS232C Port Pin Selections:
  401.  
  402.      While in the transmit mode, you may press <F8> to select or
  403.      change the input and output pin selections for the RS232 port.
  404.      When selected, a window will appear on the screen listing the
  405.      possible transmit and receive pin connections.  Just enter the
  406.      letter associated with your choice and the change will be made.
  407.      The cursor will then wait for additional inputs. This allows you to
  408.      change both transmit and receive at one time.  To remove the window
  409.      press "X".
  410.  
  411.      The various pin combinations are to allow you to use the program
  412.      with various TNC's or other interface hardware which may require
  413.      specific pin usage.
  414.  
  415.      On transmit, the output pin is driven high (plus 15V) at startup
  416.      and goes low (-15V) as characters are sent.
  417.  
  418.      On receive, the input pin is normally low and looking for a high
  419.      (+15V) when data is received.
  420.  
  421.  
  422.      To interface to most transmitters, you may use the circuit by
  423.      WA6LOD in the February 1990 QST pg 36.  This circuit uses a single
  424.      optoisolator (3 for $1.98 at Radio Shack).  The configuration is as
  425.      follows:
  426.  
  427.  
  428.  
  429.      RS232 Sig Gnd (pin 7)____________
  430.                                       |      4N28 , TIL111 etc.
  431.                                   ____|_1__________________
  432.                                   |   |                    |
  433.                                   |  ---             ______|_5________
  434.                                   |  \ /            /      |
  435.                                   | -----         |/       |      To
  436.                                   |   |     ______|        |    Positive
  437.                                   |   |     |     |\       |    Key Line
  438.               1 K                 |   |     |       \______|_4________
  439.     RS232 ___/\/\/\______|/| _____|___|     |              |
  440.      DTR   |             |\|    2 |         |  Optocoupler |    To Xmtr
  441.    (pin 4) |            1N914     |         |              |     Gnd.
  442.            |                      |_________|______________|
  443.            |                                |6
  444.         ___|___                             |NC
  445.         _______  .01 uf
  446.            |
  447.   Comp ____|
  448.   Gnd    __|_
  449.   pin 1 / / /
  450.  
  451.      If you find you need an output which is the reverse of the above,
  452.      low on positive inputs, just revers the 1N914 diode and the
  453.      connections to pin 1 and 2 of the optocoupler.  This circuit will
  454.      handle any solid state rig and can be used to drive a reed relay
  455.      for use with tube type rigs.  Just tie the upper output pin from
  456.      the opto to a 5V supply.  Connect a 5V reed relay between the lower
  457.      output pin and ground.  Each time the computer keys, the relay will
  458.      be activated.  Connect the Normally Open contacts from the relay to
  459.      your transmitter keying circuit.
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.     Receive Interface:
  467.  
  468.        10 uf       _______
  469.     _+_| |___ T 1 (    ___|AC__                      T1 = 1000 to 8 ohm
  470.        | |   )| | (   | Bridge |________ + (A)            spkr xformer
  471.              )| | (   | Recifier________                  8 ohm side used
  472.     ___| |__ )| | (   |________|         - (B)            as input.
  473.      + | |        (_______|AC
  474.        10 uf
  475.  
  476.  
  477.                       (A)____________       4N28 , TIL111 etc.
  478.                                   ____|_1__________________
  479.                                   |   |                    |
  480.                                   |  ---             ______|_5________
  481.                                   |  \ /            /      |          (C)
  482.                                   | -----         |/       |
  483.                                   |   |     ______|        |
  484.                                   |   |     |     |\       |
  485.                                   |   |     |       \______|_4________
  486.                       (B)_________|___|     |              |         |
  487.                                 2 |         |  Optocoupler |       __|_
  488.               + 12 V              |         |              |      / / /
  489.               |                   |_________|______________|
  490.               |                             |6
  491.               \                             |NC
  492.               /  2.2K     ___________________________
  493.               \          |                          |
  494.               /          |     ________________     |
  495.               |          |    |                |    |
  496.      (C)______|__________|__6_|                |_2__|
  497.               |               |                |
  498.               |    100K       |                |
  499.               |__/\/\/\_____7_|     555        |_3_________________ RS232
  500.                        |      |                |                    Pin 5
  501.                        \      |     Timer      |
  502.                    1K  /      |                |
  503.                        \      |                |_4______    _______ RS232
  504.                        /      |                |       |    |       Pin 7
  505.                        |____8_|                |_1__   |    |
  506.                          |    |________________|   |   |   _|_
  507.                          |                        _|_  |   ///
  508.                          |                       / //  |
  509.                          |_____________________________|
  510.                                                        |
  511.                                                        |
  512.                                                        /
  513.                                                    10K \
  514.                                                        /
  515.                                                        \
  516.                                                        |
  517.                                                        |
  518.                                                        +12V
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                             PRO-CW (Version 1.0)
  531.  
  532.  
  533.            Please register me as a PRO-CW user.  Enclosed is my check or
  534.            money order for $15.00.  I understand I will receive a copy
  535.            of the next release of PRO-CW when available.
  536.  
  537.  
  538.           Name: ________________________________ Call ______________
  539.  
  540.  
  541.           Address:__________________________________________________
  542.  
  543.  
  544.           City:_______________________________ State:_______ Zip:__________
  545.  
  546.  
  547.  
  548.           Computer Type:________________________________
  549.  
  550.           Ham Gear Used: ________________________________________________
  551.  
  552.  
  553.           ===============================================================
  554.  
  555.           Comments and Suggestions:
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.           Please mail with your $15 registration fee to:
  574.  
  575.             Andrew C. Manti Jr. W1VL
  576.             2 Deana Road
  577.             Methuen MA 01844